home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / f90 / flush.z / flush
Encoding:
Text File  |  2002-10-03  |  3.5 KB  |  76 lines
  1. FLUSH(3F)                                             Last changed: 2-23-99
  2.  
  3.  
  4. NNAAMMEE
  5.      FFLLUUSSHH - Writes data buffered by Fortran output statements to a file
  6.  
  7. SSYYNNOOPPSSIISS
  8.      UNICOS and UNICOS/mk systems:
  9.      CCAALLLL FFLLUUSSHH((_i_u_n_i_t))
  10.  
  11.      CCAALLLL FFLLUUSSHH((_i_u_n_i_t,,[[_i_s_t_a_t]]))
  12.  
  13.      IRIX systems:
  14.      CCAALLLL FFLLUUSSHH((_i_u_n_i_t,, _i_s_t_a_t))
  15.  
  16. IIMMPPLLEEMMEENNTTAATTIIOONN
  17.      UNICOS, UNICOS/mk, and IRIX systems
  18.  
  19. DDEESSCCRRIIPPTTIIOONN
  20.      FFLLUUSSHH writes to a file any buffered data previously written by Fortran
  21.      output statements.  FFLLUUSSHH may be called after reading or writing.  The
  22.      current file position is not changed.
  23.  
  24.      When using the CF90 compiler or MIPSpro 7 Fortran 90 compiler on
  25.      UNICOS, UNICOS/mk, or IRIX, all arguments must be of default kind
  26.      unless documented otherwise.  On UNICOS and UNICOS/mk, default kind is
  27.      KKIINNDD==88 for integer, real, complex, and logical arguments; on IRIX, the
  28.      default kind is KKIINNDD==44.
  29.  
  30.      This routine has the following arguments:
  31.  
  32.      _i_u_n_i_t     Integer variable, expression, or constant containing a
  33.                Fortran unit number.  If this value is 101, it flushes the
  34.                unit which is connected to standard output.  If this value
  35.                is 102, it flushes the unit which is connected to standard
  36.                error.
  37.  
  38.      _i_s_t_a_t     Integer variable or array element that receives the return
  39.                status as follows:
  40.  
  41.                ==00   Indicates that all buffered data, if any, was flushed.
  42.                     A file that was immediately read, or a file with a
  43.                     buffer that has not changed since the last flush, might
  44.                     return a 0 status even though no new data would be
  45.                     written to the file.
  46.  
  47.                --11   Indicates that the Fortran unit does not support FFLLUUSSHH,
  48.                     and no data was written to the file.
  49.  
  50.                >>00   Indicates that an error condition was encountered.  The
  51.                     specific error number is returned.  Use the eexxppllaaiinn(1)
  52.                     command for a description of the error code.
  53.  
  54.      The _i_s_t_a_t argument is optional on UNICOS systems; the user program is
  55.      aborted if FFLLUUSSHH is called without _i_s_t_a_t and an error condition is
  56.      encountered.
  57.  
  58. NNOOTTEESS
  59.      If FFLLUUSSHH is called with an unconnected unit, an error condition
  60.      results (except for units 101 and 102).  Calling FFLLUUSSHH for a file for
  61.      which the program does not have write permission returns a 0 status if
  62.      no data was written to that file previously with Fortran I/O
  63.      statements.
  64.  
  65.      A WWRRIITTEE I/O statement with an asterisk unit identifier (or a PPRRIINNTT
  66.      statement) uses unit 101.  See "Fortran I/O Units" in IINNTTRROO__IIOO(3F) on
  67.      UNICOS and UNICOS/mk systems for more information (IINNTTRROO__IIOO is not
  68.      available on IRIX systems).
  69.  
  70. SSEEEE AALLSSOO
  71.      eexxppllaaiinn(1) in the _U_N_I_C_O_S _U_s_e_r _C_o_m_m_a_n_d_s _R_e_f_e_r_e_n_c_e _M_a_n_u_a_l to see a
  72.      description of the error code.
  73.  
  74.      _A_p_p_l_i_c_a_t_i_o_n _P_r_o_g_r_a_m_m_e_r'_s _L_i_b_r_a_r_y _R_e_f_e_r_e_n_c_e _M_a_n_u_a_l for the printed
  75.      version of this man page.
  76.